Day 7 初探Notion API vol.3

15th鐵人賽

guancioul

2023-09-22 12:02:47

195 瀏覽

分享至

今天來講講Postman和Notion API試打的結果

Postman

Postman API Platform | Sign Up for Free

這邊是Postman的官網，這個程式主要就是執行http request的方法，常見的有這些方法

GET：主要是用來請求資料
POST：將要修改的內容提供給url，類似於update的感覺
PUT：如果有要更新的內容但是參數沒有帶的話，會被更新成空的
PATCH：有要更新的內容但是參數沒有帶的話，該參數不會被動到
DELETE：刪除某個row

這邊我使用的是mac版的Postman，介面大概長這樣

進到程式後，會需要登入或是跳過登入，這部分就不細講了，總之成功進入到頁面後會是上面這個樣子

接著我們來講一下Notion Create Database的部分

Notion Create Database

curl --location --request POST 'https://api.notion.com/v1/databases/' \
--header 'Authorization: Bearer '"$NOTION_API_KEY"'' \
--header 'Content-Type: application/json' \
--header 'Notion-Version: 2022-06-28' \
--data '{
    "is_inline": true,
    "parent": {
        "type": "page_id",
        "page_id": "$uuid"
    },
    "icon": {
    	"type": "emoji",
			"emoji": "📝"
  	},
  	"cover": {
  		"type": "external",
    	"external": {
    		"url": "https://website.domain/images/image.png"
    	}
  	},
    "title": [
        {
            "type": "text",
            "text": {
                "content": "Grocery List",
                "link": null
            }
        }
    ],
    "properties": {
        "Name": {
            "title": {}
        },
        "Description": {
            "rich_text": {}
        },
        "In stock": {
            "checkbox": {}
        },
        "Food group": {
            "select": {
                "options": [
                    {
                        "name": "🥦Vegetable",
                        "color": "green"
                    },
                    {
                        "name": "🍎Fruit",
                        "color": "red"
                    },
                    {
                        "name": "💪Protein",
                        "color": "yellow"
                    }
                ]
            }
        },
        "Price": {
            "number": {
                "format": "dollar"
            }
        },
        "Last ordered": {
            "date": {}
        },
        "Store availability": {
            "type": "multi_select",
            "multi_select": {
                "options": [
                    {
                        "name": "Duc Loi Market",
                        "color": "blue"
                    },
                    {
                        "name": "Rainbow Grocery",
                        "color": "gray"
                    },
                    {
                        "name": "Nijiya Market",
                        "color": "purple"
                    },
                    {
                        "name": "Gus's Community Market",
                        "color": "yellow"
                    }
                ]
            }
        },
        "+1": {
            "people": {}
        },
        "Photo": {
            "files": {}
        }
    }
}'

上面這段是在Notion Create Database頁面的內容，上面提到的NOTION_API_KEY就是昨天說到的內容，接著先把這些內容放進Postman中看能不能生成出一個Database

首先先按這邊的+號，會出現以下內容

接著由於看到上面的內容中是使用POST，所以需要把GET改成POST

接著在URL的地方輸入https://api.notion.com/v1/databases/

並且把下面的部分開到Headers

在Headers的部分打上

Key	Value	Note
Authorization	Bearer $NOTION_API_KEY	Bearer記得要加，Notion API Key不需要雙引號或單引號
Content-Type	application/json
Notion-Version	2022-06-28	官網說這個部分一定要加，並且以這個版本為主，如果有更新的話以官網為主